home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / comm / net / Speak_Freely.lha / speakfreely / man / sflwld < prev    next >
Text File  |  1996-08-24  |  6KB  |  199 lines
  1.  
  2.  
  3.  
  4. SFLWLD(1)                 User Commands                 SFLWLD(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      sflwld - Speak Freely Look Who's Listening server
  10.  
  11. SYNOPSIS
  12.      sflwld [ -duv ] [ -f_s_e_r_v_e_r,...  ] [ -h_p_a_t_h ] [ -i_i_n_t_e_r_v_a_l ]
  13.             [ -m_m_s_g_f_i_l_e ] [ -p_p_o_r_t ] [ -z_p_a_t_h ]
  14.  
  15. DESCRIPTION
  16.      sflwld is a server daemon which maintains a  list  of  users
  17.      running  Speak  Freely  who  identify themselves to the site
  18.      running the server.  sflwld responds to  requests  and  sup-
  19.      plies  contact  information  to  allow  users  to  find  one
  20.      another's Internet addresses.  sflwld allows users  to  find
  21.      one another and establish Speak Freely conversations even if
  22.      one or both have dial-up Internet connections where the host
  23.      name  and  Internet  address  vary  from session to session.
  24.      Servers can forward information to one another,  allowing  a
  25.      user  who  queries one server in a mutually-forwarding group
  26.      to find users connected to any server in the group.
  27.  
  28. OPTIONS
  29.      -d         Enables debug output.
  30.  
  31.      -f_s_e_r_v_e_r,...
  32.                Information received from users directly connected
  33.                to  this  server  will be forwarded to all servers
  34.                listed.  Server names can be either numeric IP ad-
  35.                dresses  or  host  names,  and  may specify a port
  36.                number appended to the  server  address  or  name,
  37.                separated  by  a  colon.   Multiple servers can be
  38.                specified, separated by commas, up to a maximum of
  39.                5.
  40.  
  41.      -h_p_a_t_h     An HTML file is written to the given _p_a_t_h name (a
  42.                fully qualified file name, less the .html suffix),
  43.                listing all users currently registered  with  this
  44.                server.  Publishing this HTML file as a World-Wide
  45.                Web document on the server allows easy access to a
  46.                list  of  all active users who have sent their in-
  47.                formation there.
  48.  
  49.      -i_i_n_t_e_r_v_a_l
  50.                The HTML files written by the -h and  - z  options
  51.                will be updated every _i_n_t_e_r_v_a_l seconds if a change
  52.                has occurred during that period.  If  _i_n_t_e_r_v_a_l  is
  53.                set  to  zero, the files are updated at the moment
  54.                of any change.
  55.  
  56.      -m_m_s_g_f_i_l_e  The contents of the text file _m_s_g_f_i_l_e are  loaded
  57.                and  used as the ``server welcome message''.  This
  58.                message usually identifies the server  and  points
  59.                to  the  HTML  file  containing the list of active
  60.  
  61.  
  62.  
  63. SunOS 5.4           Last change: 23 APR 1996                    1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SFLWLD(1)                 User Commands                 SFLWLD(1)
  71.  
  72.  
  73.  
  74.                sites.
  75.  
  76.      -p_p_o_r_t     Causes sflwld to listen  on  the  specified  port
  77.                number  instead  of  the default port specified by
  78.                ``INTERNET_PORT''+2 in the Makefile.  Specifying a
  79.                nonstandard  port  number  will cause Speak Freely
  80.                clients that haven't been  similarly  reconfigured
  81.                to fail to contact the server; the main reason for
  82.                using a nonstandard port number is to permit test-
  83.                ing  an  experimental server on a machine which is
  84.                running a production server.
  85.  
  86.      -u         Prints how-to-call information.
  87.  
  88.      -v         Causes sflwld to log all connections,  disconnec-
  89.                tions, and timeouts to standard output.
  90.  
  91.      -z_p_a_t_h     An HTML file is written to the given _p_a_t_h name (a
  92.                fully qualified file name, less the .html suffix),
  93.                listing all users currently registered  with  this
  94.                server,  regardless of whether they requested pub-
  95.                lic disclosure of their identity by wildcard match
  96.                or not.  This option allows the system administra-
  97.                tor to see all users communicating with the server
  98.                without  making  this  information publicly avail-
  99.                able.  There's nothing to  prevent  a  rogue  site
  100.                manager  from  publishing  the complete user list,
  101.                but since a user can easily  determine  whether  a
  102.                request  for  "exact match only" has been complied
  103.                with, circumspect users will shun sites which  ig-
  104.                nore their request for discretion.
  105.  
  106. FILES
  107.      The -h and -z options create HTML files with the given  base
  108.      name  and  an extension of .new, then swap the new files for
  109.      any previously-existing files with an  extension  of  .html.
  110.      The  file  update  process avoids the risk of transferring a
  111.      file in the process of being written.
  112.  
  113. BUGS
  114.      The number of matching items returned  is  limited  to  what
  115.      will  fit  in a single 512 byte packet.  This is deliberate;
  116.      users who wish to browse active  sites  should  consult  the
  117.      HTML  file  published  with the -h option rather than tie up
  118.      the server running  sflwld  with  individual  wild-card  re-
  119.      quests.
  120.  
  121. SEE ALSO
  122.      sflwl(1), sfmike(1), sfspeaker(1)
  123.  
  124. AUTHOR
  125.           John Walker
  126.  
  127.  
  128.  
  129. SunOS 5.4           Last change: 23 APR 1996                    2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. SFLWLD(1)                 User Commands                 SFLWLD(1)
  137.  
  138.  
  139.  
  140.           E-mail: kelvin@fourmilab.ch
  141.           WWW:    http://www.fourmilab.ch/
  142.  
  143.      This program is in the public domain.
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. SunOS 5.4           Last change: 23 APR 1996                    3
  196.  
  197.  
  198.  
  199.